序本文主要研究一下如何使用spring-ai-starter-mcp-server进行自定义mcp server步骤pom.xml <dependency> <groupId >org.springframework.ai</groupId> <artifactId>spring-ai-starter-mcp-server-webmvc</artifactId query")public String query(String param1) {return "hello" + param1;}}源码syncToolsorg/springframework/ai/mcp serverProperties);}syncTools这一部分把ToolCallback转为SyncToolSpecifications注册到spring中mcpSyncServerorg/springframework/ai/mcp serverBuilder.build();}mcpSyncServer会把注入的List、List、List、List设置到serverBuilder的tools、resources、prompts中小结spring ai mcp
一、项目定位与核心价值 MCP(Model Context Protocol)Gateway 是面向 Kubernetes 环境的反向代理与管理层,专为 会话感知的路由 与 MCP 实例生命周期管理 设计 Adapters:在 /adapters 路径下注册的逻辑资源,代表各 MCP 实例,可与其他资源(如 /agents)共存。 四、控制平面 API(示例) 方法 路径 功能 POST /adapters 部署并注册新 MCP GET /adapters 列出所有 MCP GET /adapters/{name} 获取适配器元数据 / │ └─ Microsoft.McpGateway.Management/ ├─ mcp-example-server/ # 示例 MCP 服务器 ├─ deployment/ 九、结语 MCP Gateway 为构建 可扩展、会话感知、企业级安全 的模型服务平台提供了完整的技术方案。
大家好,我是人月聊IT,今天推荐一本关于MCP的书籍。 1. 大模型,MCP和AI Agent 大家可以看到最近MCP,AI Agent,上下文工程等一直是一个讨论的热点。 聊聊MCP开发从入门到实战 对于MCP原理和MCP开发的书我最近看了好几本,从里面选择一本我认为写得还不错得进行推荐。即人民邮电出版社出版的《MCP开发-从入门到实践这本书》。 为何推荐这本书,说几个关键点: MCP基础概念,把核心组件,提示词,资源,协议,工具讲解很清楚 偏应用实战,没有花太多篇幅去大量接收MCP底层原理 基于Claude Desktop来讲MCP应用和配置 给出了完整的一个MCP Server开发例子,步骤很清晰易懂 详细讲解了MCP Inspector交互Debug工具使用 结合MCP生态,给出了当前主流的MCP Server配置使用 所以我整体读下来, 而这本书基本是一本偏开发和实战的书,让你能够快速上手。 具体书籍的核心内容,参考出版社的介绍如下: 第1章介绍了MCP的基本概念、技术特点及其架构。
一、MCP核心底层逻辑与核心价值 1.1 MCP的本质与底层架构 MCP全称Model Context Protocol,是由OpenAI牵头推出的标准化开放协议,核心目标是打通大模型与外部系统、工具、 从底层来看,MCP是基于JSON-RPC 2.0规范的应用层协议,定义了大模型客户端(MCP Client)与外部服务(MCP Server)之间的通信标准、消息格式、能力发现与调用规范。 可观测性:MCP调用的日志、指标、链路追踪完全复用原有服务的可观测体系,实现全链路可监控、可排查 2.2 改造全流程 三、全链路改造实战落地 3.1 环境与依赖配置 项目基于JDK 17开发,核心pom.xml </configuration> </plugin> </plugins> </build> </project> 3.2 存量业务服务现状 本次实战以企业最常见的用户管理存量服务为例 //127.0.0.1:8080/mcp/jsonrpc MCP WebSocket服务,访问路径为ws://127.0.0.1:8080/mcp/ws 4.2 标准化能力发现验证 MCP协议定义了标准化的能力发现机制
MCP详解及手把手实战 Model Context Protocol(MCP)是一个开放协议,旨在标准化大型语言模型(LLM)与外部数据源和工具之间的集成方式。 什么是 MCP? MCP 可以被视为 AI 应用程序的“USB-C 接口”。正如 USB-C 提供了连接各种设备的标准化方式,MCP 为 LLM 提供了访问多种数据源和工具的统一协议。 如何开始使用 MCP? MCP 提供了多种入门路径: 快速入门:通过示例服务器连接到 Claude Desktop,快速体验 MCP 的功能。 开发一个MCP服务端 该服务端包含功能: 查询数据库用户信息 新增用户信息到数据库 MCP服务端数据表 MCP服务端代码 from mcp.server import FastMCP from selenium.webdriver () 编写代码之后运行 MCP客户端 使用vscode中的cline作为MCP客户端在进行模型对话的时候调用MCP服务端 安装cline插件 编辑cline中MCP服务端的配置文件 使用查询用户信息的询问
01 — Fastapi MCP Server 实现 1、Fastapi框架中可以同时实现http restful接口和mcp server。 服务器实例,绑定到 FastAPI app `` mcp = FastApiMCP(app) `` # 挂载 MCP 服务器,默认路径是 /mcp(可以修改) `` mcp.mount() `` ` 4、Cherry Studio验证mcp server fastapi中的FastApi和MCP Server也可以分开独立部署,适用于将 MCP 服务与主 API 在物理上隔离,或者为 MCP 使用不同的安全策略的场景 mcp server。 后续整个项目顺利投产后,应该再总结一篇在生产环境中的项目实战总结。
开发 MCP Server 假设我们提供 web 搜索功能,那么怎么通过 MCP 对接到大模型上呢? 开发 MCP Client 上面开发了 MCP Server,那么怎么让大模型调用 MCP Server 呢? 步骤如下: 首先将支持本地的 MCP Tools 列表提供给大模型 其次约束大模型在回答某一类问题,或者不能获取知识时让系统调用 MCP Server 最后将 MCP Server 返回的内容提供给大模型总结 服务器向 MCP 客户端发送sampling/createMessage请求 MCP 客户端审查该请求,并可以进行修改 MCP 客户端从 LLM 中生成一个结果 MCP 客户端审查生成的结果 MCP 资源或者项目 MCP 官方提供了很多服务,可以参考:https://mcp.so/。
02 — MCP介绍 MCP(Model Context Protocol,模型上下文协议)是由Anthropic公司推出的一个开放标准协议,目的就是为了解决 AI 模型与外部数据源、工具交互的难题。 通过下图,可以很容易明白MCP Server 、 MCP Client、MCP HOST之间的关系。 笔者下文中用到的MCP HOST工具为 Cherry Studio。 届时实际公司内网环境中应该会去用Dify来作为MCP HOST。 # main.py from fastmcp import FastMCP mcp = FastMCP("Demo",port=9000) @mcp.tool() def add(a:int, b 如上这个例子,在Cherry Studio中将硅基流动大模型和配置的MCP Server封装成了一个简单的Agent智能体,完整地实现了智能体通过MCP协议调用MCP Server自主完成了一次加法计算的简易流程
1.前言虽然这个AI已经火了很久,无论是这个智能体,还是这个MCP之类的,都是非常流行的吧,但是其实我一直想要深入的学习一下这个MCP,我之前对于这个MCP的理解仅仅停留在这个使用cursor里面的配置 ,结合这个高德地图,微信读书做的两个小小的工具,而且那个时候应该是4月份,也就是我们的这个MCP刚刚兴起的哪个阶段,现在这个MCP已经是非常流行的了,但是我还是决定耐着性子吧这个里面的相关的原理学习梳理一下 ,因为我觉得自己对于MCP的理解还不是非常的深刻,但是我知道这个MCP的重要性还是非常的。 ,还有一些是和我们的这个Github相关的操作,这个时候我们的示意图变成了下面的这个样子:下面的这个就是有MCP和没有MCP的这个区别:1)没有这个MCP协议的时候,不同的这个大模型使用我们的不同的工具调用的时候这个标准可能是有所区别的 就是生效的;4.MCP本质通过上面的过程,我们可以发现,这个MCP其实没啥神秘的,就是我们的客户端调用MCP(nodejs程序,或者是python之类的程序),这个调用的程序执行操作,返回了一些我们想要的结果
为了让想掌握MCP的同学能顺利入门,小异带来了一本权威指南《MCP轻松学——全能AI实战宝典》,这本书从基础概念到实战操作,帮助读者快速掌握MCP开发技巧。 MCP采用客户端-服务器架构,包含以下组件: MCP宿主:宿主应用程序包含MCP客户端组件,使用MCP连接各种资源的应用程序,例如AI助手(如Claude桌面应用)、开发环境(如Cursor、Cline 好在现在有了《MCP轻松学——全能AI实战宝典》!本书采用循序渐进的结构设计,从MCP基础知识到高级应用,逐步引导读者深入理解MCP的工作原理与实现方法。 Part.4 结语 《MCP轻松学——全能AI实战宝典》的独到之处在于: 全面涵盖:提供MCP技术的完整概述,包括其架构、组件和工作原理。 深入剖析:详细介绍MCP SDK的使用方法,帮助开发者快速上手。 实战落地:探讨MCP在各种应用场景中的实际应用,提供可复制的解决方案,书中的代码示例和案例研究也都是经过精心设计的。
03-MCP客户端开发实战概述在前两篇文章中,我们分别介绍了MCP协议的基本概念和如何构建MCP服务器。 本文将详细介绍如何开发MCP客户端,包括stdio和HTTP两种传输方式的实现,以及如何调用工具、读取资源和获取提示模板。 MCP客户端架构客户端职责MCP客户端负责与MCP服务器建立连接,并管理与服务器的交互:建立和维护服务器连接发现服务器提供的工具、资源和提示模板调用工具并处理返回结果读取资源并解析数据获取提示模板并应用核心组件传输层 ","http://localhost:8000/mcp"),timeout=int(os.getenv("MCP_TIMEOUT","30")),max_retries=int(os.getenv(" 客户端的开发,包括:Stdio模式客户端的完整实现HTTP模式客户端的完整实现核心API的详细使用方法高级功能和最佳实践测试和故障排查在下一篇《LLM与MCP集成实践》中,我们将学习如何将MCP工具集成到
前言最近热衷于找一些好玩的MCP,集成在cursor中,给大模型外挂许多有趣的功能,例如:什么是MCP? 本地如何开发MCP ServerMCP实战 | cursor 如何一句话操作 gitHub 代码库cursor 如何调用 MCP server 实现天气查询自定义 MCP Server,在 cursor 中连接本地 MySQL 实现了统计分析Pages MCP Server + cursor,一句话完成旅游出行规划今天分享的两个mcp server:mcp-yfinance 和 Financial Datasets mcp server 下载这两个 mcp server 要求python版本在3.10以上即可,需要将源码部署到本地。 /mcp-yfinance/server.py" ] } }}在MCP页面就可以看到配置的 mcp server 信息。
2.1 MCP 的核心定位(先说人话) 在技术领域中,MCP(Model Context Protocol)有着其独特的定义和范畴,MCP(Model Context Protocol)并不是: 它并非是对象关系映射 而MCP有着与ORM截然不同的功能和应用场景,它并不承担将对象模型映射到关系数据库的任务。 MCP也不是远程过程调用RPC。 但MCP并不具备RPC那种跨网络调用远程服务的特性,它有着自己独立的工作模式和目标。 同时,MCP也不是软件开发工具包SDK。 ) 把模型的 Tool 调用,转化为真实的 FastAPI 请求 3.2 MCP 中几个关键名词解释(工程向) MCP Tool MCP Tool 是专门为模型调用而精心设计的“能力单元”,它与普通的 MCP Client MCP Client 是大模型运行的重要环境,其主要功能是用来发现和调用 Tool。
(modelcontextprotocol.io,mcp-framework.com)1Transport层的角色与分类1.1消息如何被送达MCP核心报文采用JSON-RPC2.0格式(modelcontextprotocol.io 由于采用接口隔离原则,协议对底层信道保持“可插拔”——任何支持全双工字节流的介质都能承载MCP。 4TypeScript实战:构建stdioServer与Client依赖:npmi@modelcontextprotocol/sdk展开代码语言:TXTAI代码解释//server.tsimport{McpServer (github.com,github.com)5PythonFastMCP实战依赖:pipinstallfastmcp展开代码语言:TXTAI代码解释#server.pyfromfastmcpimportFastMCPmcp 结语stdio传输凭借极低的依赖与极高的吞吐,在MCP生态里占据入口级地位。从快速原型到生产CLI,都能看到它的身影。
在一文带你入门 MCP(模型上下文协议)文章中,我们快速介绍了 MCP 的基本概念,并且通过一个示例让读者初步感受到了 MCP 的强大能力。 from mcp.server.fastmcp import FastMCP MCP_SERVER_NAME = "elasticsearch-mcp-server" mcp = FastMCP(MCP_SERVER_NAME 使用 @mcp.tool() 装饰器将这两个函数标记为 MCP 的 Tool。 使用 MCP Inspector 调试 MCP Server MCP Inspector 是一个交互式的开发者工具,专门用于测试和调试 MCP 服务器。 执行以下命令可以启动 MCP Inspector: mcp dev server.py 启动成功后,浏览数输入 http://localhost:5173 打开 MCP Inspector 界面。
MCP Server/Client 的开发,各个大厂也纷纷推出自己的 MCP 集成平台或开放 MCP 接口。 也有一些朋友读者在技术群讨论 MCP 技术,很多人对 MCP 的机制不清楚,也有一些文章讲解 MCP 时不够清晰甚至误导了读者,所以笔者在这个周末在学习 MCP 时,写下该笔记,尽可能提供更多的示例和讲解 根据 MCP 协议的规定,在 MCP 协议中有以下对象: MCP Hosts: 如 Claude Desktop、IDE 或 AI 工具,希望通过 MCP 访问数据的程序; MCP Clients: 制定自然语言响应; 响应显示给你; 这个过程并不是只有一两次,可能发生多次,具体细节将会在 高德地图 MCP 实战 中讲解,这里只是简单提及。 实战 聊了这么久,终于到了实战对接环节,本节将会通过高德地图案例讲解 MCP Tool 的逻辑细节和对接使用方式。
对于刚接触的朋友来说,MCP 和 MCP Server 可能有些陌生。别担心,接下来我们会一步步探索它们的玩法:从认识概念,到简单操作,再到实战开发。 流程图如下:⚠️ 本文纯手敲, 涵盖了理论知识+实战知识, 如果您觉得帮助到了您,请给我点个 如果本文有错别字,或者有不对的地方请指出谢谢啦! 本期内容涉及较多, 本次的理论知识较多,如果你已经掌握了理论那么可以直接前往项目实战开发MCP Server 开发技术选型:Java + Spring Ai 来完成我们的腾讯云开发者社区 MCP Server 接下来我带着大家手把手使用 Java 语言制作自己的 MCP Server 项目实战 - 自定义 MCP Server在上面我们已经简单玩了下 MCP Server , 接下来我带着大家动手做一个 MCP : 沙箱账户 去获取这舒服的界面, 我也是有钱人了, 演戏嘛我就是有钱人接着回去说, 支付好了, 就会给我生成文章了,那么 本期文章 《从零玩转系列之 MCP AI Agent 理论+项目实战开发你的MCP
本文深入探讨MCP与ReAct架构的集成方法,通过智能旅行规划Agent实战案例,展示如何构建自主推理和行动的智能Agent。 核心更新与变化 2.1 MCP v2.0在Agent集成方面的核心更新 相比MCP v1.0,v2.0版本在Agent系统集成方面做出了多项重要更新: 特性 MCP v1.0 MCP v2.0 工具定义 与多Agent系统的集成 MCP支持多Agent系统的集成,主要通过以下机制实现: Agent注册与发现:Agent可以在MCP服务器上注册自己的能力和服务 Agent间通信:通过MCP的消息传递机制实现 的协议,如MCP 多模态应用:推荐使用支持多模态的协议,如MCP v2.0 5. 工程化实践与最佳实践 5.1 实战案例:智能旅行规划Agent 5.1.1 系统架构设计 我们构建了一个基于ReAct架构和MCP的智能旅行规划Agent,该Agent能够根据用户需求,自动规划旅行行程
MCP Server/Client 的开发,各个大厂也纷纷推出自己的 MCP 集成平台或开放 MCP 接口。 也有一些朋友读者在技术群讨论 MCP 技术,很多人对 MCP 的机制不清楚,也有一些文章讲解 MCP 时不够清晰甚至误导了读者,所以笔者在这个周末在学习 MCP 时,写下该笔记,尽可能提供更多的示例和讲解 根据 MCP 协议的规定,在 MCP 协议中有以下对象: •MCP Hosts: 如 Claude Desktop、IDE 或 AI 工具,希望通过 MCP 访问数据的程序; •MCP Clients ; 5.LLM 制定自然语言响应; 6.响应显示给你; 这个过程并不是只有一两次,可能发生多次,具体细节将会在高德地图 MCP 实战中讲解,这里只是简单提及。 实战 聊了这么久,终于到了实战对接环节,本节将会通过高德地图案例讲解 MCP Tool 的逻辑细节和对接使用方式。
该文章已被 Model Context Protocol(MCP) 中文教程讲解 收录,欢迎 star 收藏。 前言随着 MCP 的快速普及和广泛应用,MCP 服务器也层出不穷。 大多数开发者使用的 MCP 服务器开发库是官方提供的 typescript-sdk,而作为 Go 开发者,我们也可以借助优秀的第三方库去开发 MCP 服务器,例如 ThinkInAIXYZ/go-mcp mcp-ip-geo 服务器mcp-ip-geo 是一个用于查询 IP 信息的 MCP 服务器,项目已开源,仓库地址:mcp-ip-geo。 /cmd/mcp-ip-geo # 在 Windows 上 go build -o mcp-ip-geo.exe . /cmd/mcp-ip-geo@latest MCP 集成你可以通过以下两种方式集成 mcp-ip-geo 服务: 可执行文件集成(本地运行){ "mcpServers": { "mcp-ip-geo